shadowPattern

Type

property

Summary

Specifies the pattern of an object's drop shadow.

Syntax

set the shadowPattern of <object> to {<patternNumber> | <imageID> | empty}

Description

Use the shadowPattern property to specify the drop shadow pattern of a field or button or the background pattern of a scrollbar.

Pattern images can be color or black-and-white.

Cross-platform note

To be used as a pattern on Mac OS|Mac OS systems, an image must be 128x128 pixels or less, and both its height and width must be a power of 2. To be used on Windows and Unix systems, height and width must be divisible by 8. To be used as a fully cross-platform pattern, both an image's dimensions should be one of 8, 16, 32, 64, or 128.

The shadowPattern of controls is drawn starting at the control's upper right corner: if the control is moved, the pattern does not shift.

Setting the shadowPattern of an object to empty allows the shadowPattern of the object's owner to show through. Use the effective keyword to find out what color is used for the object, even if its own shadowPattern is empty.

The setting of the shadowPattern property has different effects, depending on the object type:

• The shadowPattern of a stack, card, or group determines the shadowPattern of each object in the stack, card, or group that does not have its own shadowPattern.

• The shadowPattern of a button is used for the button's drop shadow. If the button's style is menu (unless the menuMode is tabbed), the shadowPattern has no effect. If the button is a tabbed button, the shadowPattern is always used for the inactive tabs; otherwise, if the button's shadow property is false, the shadowPattern has no effect.

• The shadowPattern of a field determines the pattern used for the field's drop shadow. If the field's shadow property is false, the shadowPattern has no effect.

• The shadowPattern of a scrollbar determines the background pattern of the scrollbar.

• The shadowPattern of a graphic, image, player, audio clip, video clip, or EPS object has no effect.

If an object's shadowPattern is set, the pattern is shown instead of the color specified by the shadowColor.

Examples

set the shadowPattern of next card to empty

set the shadowPattern of last button to 409

Related

object: button, field, stack

property: pixels, backgroundPattern, height, style, shadow, owner, borderPattern, width, shadowColor, bottomPattern

command: group

function: stacks

glossary: object, property, EPS, audio clip, tabbed button, Windows, object type, Mac OS, keyword, Unix, video clip, current stack, control

keyword: effective, field, image, button, shadow, player, control, card, scrollbar, graphic

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile